🎯 Objetivo

Implementa o pipeline completo de auto-apply para a SCRUM-52: permite aplicar sugestoes de melhoria (geradas por relatorio IA) diretamente nos dados da empresa e do cardapio, tanto de forma individual quanto em lote a partir de um relatorio existente.

📁 Arquivos Criados

✏️ Arquivos Alterados

🧪 Como Testar

Pré-requisitos

1. Abrir o deploy do PR: https://mandaca-backend-staging-pr-37.onrender.com/docs
2. Ter no banco uma empresa cadastrada com pelo menos um item de cardapio e um relatorio IA gerado

Teste 1: Auto-apply individual (POST /auto-apply)

1. No Swagger, localizar a seção auto-apply e expandir POST /auto-apply
2. Clicar em Try it out
3. Preencher o body com um campo permitido de empresa:

{
  "enterprise_id": "<UUID da empresa>",
  "target": "enterprise",
  "campo_para_alterar": "historia",
  "novo_valor": "Restaurante familiar fundado em 2010 no sertao pernambucano"
}

4. Clicar em Execute
5. Esperado: status 200 com body {"campo_alterado": "historia", "status": "aplicado"}
6. Verificar no GET /enterprises/{id} que o campo historia foi atualizado

Teste 2: Auto-apply de item do cardapio (POST /auto-apply)

1. Repetir o fluxo acima, mas agora com target menu_item:

{
  "enterprise_id": "<UUID da empresa>",
  "target": "menu_item",
  "menu_item_id": "<UUID do item de cardapio>",
  "campo_para_alterar": "preco",
  "novo_valor": "25.90"
}

2. Esperado: status 200 com {"campo_alterado": "preco", "status": "aplicado"}

Teste 3: Campo nao permitido (POST /auto-apply)

1. Enviar um campo fora da whitelist (ex: "campo_para_alterar": "owner_id")
2. Esperado: status 422 com mensagem "Campo não permitido para alteração automática: owner_id"

Teste 4: Auto-apply em lote a partir de relatorio (POST /reports/{report_id}/auto-apply)

1. Primeiro, gerar um relatorio via POST /reports/generate/{empresa_id} e copiar o id_relatorio retornado
2. No Swagger, localizar a seção reports e expandir POST /reports/{report_id}/auto-apply
3. Clicar em Try it out e colar o report_id
4. Clicar em Execute
5. Esperado: status 200 com body contendo:
   • report_id: UUID do relatorio
   • total: quantidade de sugestoes extraidas pela IA
   • aplicadas: quantas foram aplicadas com sucesso
   • rejeitadas: quantas falharam (campo invalido, entidade nao encontrada, etc.)
   • resultados: lista detalhada com cada sugestao, seu status (aplicado/rejeitado) e mensagem de erro quando rejeitada
6. Verificar nos endpoints GET /enterprises/{id} e GET /menus/{id} que os campos aplicados foram atualizados

Teste 5: Relatorio inexistente (POST /reports/{report_id}/auto-apply)

1. Enviar um UUID que nao existe como report_id
2. Esperado: status 404 com mensagem "Relatório IA não encontrado: <UUID>"

Testes automatizados

pytest tests/test_auto_apply_service.py tests/test_report_auto_apply_service.py tests/test_auto_apply_router.py tests/test_reports_router.py -v